home *** CD-ROM | disk | FTP | other *** search
/ Amoszine 8 / Amoszine 8 (Disk 2 of 3).adf / BELL.lha / BELL.DOC next >
Text File  |  1992-03-06  |  13KB  |  433 lines
  1. Bell V1.0 is a VERY early version of a little experiment to create an
  2. easy to learn and use mini programming enviroment. At the moment there are
  3. very few instructions available. Most of the instructions are quite limited
  4. to keep things simple. BELL (Beginners Easy Learning Language) is obviously
  5. aimed at the absolute beginner who wants to cut his/her programming teeth on
  6. something easy and quick. The programs (or more precisely, scripts) that can
  7. written at this stage are vry limited of course but I amlooking for
  8. ideas/feedback comments etc. before continuing this project.
  9.  
  10. Send your letters to:
  11.  
  12. Steve Bye
  13. 31, Wellington Road
  14. Exeter, Devon.
  15. EX2-9DU
  16.  
  17. If you want the latest copy of BELL include a stamp and a disk.
  18. I will only reply when a newer version is ready,so it may be a while before
  19. you get a reply. Don't forget to mention which version you have. 
  20. This is version 1.0b
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29. CONTENTS:
  30.  
  31. Part 1,  The Bell commands index in Alphabetical order.
  32.  
  33. Part 2,  Bell disk set up.
  34.  
  35. Part 3,  The Bell Picture Packer
  36.  
  37. Part 4,  The Bell Sample Speed Player 
  38.  
  39. Part 5,  Bell Runtime Errors.
  40.  
  41. Part 6,  Example programs.
  42.  
  43. Part 7,  making a bootable/distributable disk.
  44.  
  45. Part 8,  Tutorial
  46.  
  47. part 8,  Limitations of Bell
  48.  
  49.  
  50. <<<<<Part 1>>>>>>
  51.  
  52. Bell V1.0 Commands index:
  53. -------------------------
  54.  
  55.  
  56.  
  57. APPEAR PIC [file number]
  58.  
  59. Loads in and fades in a picture described in [file number]
  60.  
  61.  
  62. EXAMPLE:
  63.  
  64. Appear Pic 1 
  65. ----------------------------------------------------------------------------
  66.  
  67. CLEAR SCREEN [colour number]
  68.  
  69. Clears the current screen of any pictures or text, leaving it blank and in
  70. the colour specified by [number]. This "number" refers to the current 
  71. palette number. The best way to find out which colour is what is to
  72. experiment. Remember though if you try a number too high you will get
  73. an error. The range of [number] starts at 0, which is usually black and
  74. the maximum number is 1- the amount of colours used in the current palette.
  75. So if for example you had a 16 colour picture displayed you could clear it
  76. with Clear Screen 0 right up to Clear screen 15.
  77.  
  78. EXAMPLE:
  79. Clear Screen 0
  80. Clear the screen with colour 0, usually black.
  81. ----------------------------------------------------------------------------
  82.  
  83. END
  84.  
  85. Used to terminate your program neatly. Put in the very last line of your
  86. program.
  87. ----------------------------------------------------------------------------
  88.  
  89. FADE SCREEN [Speed]
  90.  
  91. This fades out the contents of the currently displayed screen.
  92. [Speed] is the speed at which the fade works, a minimum value of 1 must be
  93. used, which is very fast.
  94.  
  95. EXAMPLE:
  96. Fade Screen 5
  97. fade out the current screen at speed 5.
  98. ---------------------------------------------------------------------------- 
  99.  
  100. MESSAGE
  101. Your text here
  102.  
  103. Use the Message instruction to make text appear on the current screen.
  104. This is useful for short staements like "Press a key" or "Click mouse
  105. button" or "This program was written using the Bell language." etc.
  106. The actual text you want displayed must be less than 80 characters in total.
  107. You can get around this by having more than one MESSAGE instruction in your
  108. program of course.
  109. The text will be centered on screen for you.  It is important to put the text
  110. you want displayed on the line AFTER the message instruction. The text wil
  111. be displayed at the current text curs.
  112.  
  113. EXAMPLE:
  114. Message
  115. your text here on the line after the message instruction
  116.  
  117. Prints a message centered on screen. 
  118. ----------------------------------------------------------------------------
  119.  
  120. MOUSE OFF
  121.  
  122. This hides the mouse pointer from the users view.
  123.  
  124. EXAMPLE:
  125. Mouse Off
  126. ----------------------------------------------------------------------------
  127.  
  128. MOUSE ON
  129.  
  130. This brings back the mouse pointer so the user can see/use it.
  131.  
  132. EXAMPLE:
  133. Mouse On
  134. ---------------------------------------------------------------------------- 
  135.  
  136. NO DRIVE CLICK
  137.  
  138. This instruction executes a tiny but brilliant PD utility called "Clicknot".
  139. It stops all floppy drives from clicking when empty. 
  140. Will only work on WB2 or higher machines, so if you want your Bell program
  141. to work on an A500 then don't use this.
  142.  
  143. EXAMPLE:
  144.  
  145. NO DRIVE CLICK
  146. ----------------------------------------------------------------------------
  147.  
  148. PAUSE [seconds]
  149.  
  150. This freezes the program for the amount od seconds stipulated in [number].
  151.  
  152. EXAMPLE:
  153. Pause 7
  154. Freeze program for 7 seconds then continue as usual.
  155.  
  156. ----------------------------------------------------------------------------
  157.  
  158. PLAY MUSIC [file number]  
  159.  
  160. Plays a Tracker music module (file name) from DF0:Music/.
  161.  
  162. EXAMPLE: 
  163. Play Music 1
  164. plays DF0:Music/music1
  165. ---------------------------------------------------------------------------- 
  166.  
  167. PLAY SAMPLE [file number] [Playback speed]
  168.  
  169. All samples must be IFF samples, if in doubt try the "Sam_speed" program
  170. to see if they sound ok. See below for more detail on "Sam_Speed".
  171.  
  172. As expected, you need to store all your samples in a drawer
  173. called.unsurprisingly, "samples/" The file names must go like this:
  174. Sam1. sam2, sam3 etc.
  175. [Filename] is simply the number, ie. to play sam1 you just put PLAY SAMPLE 1
  176. But you also need to supply BELL with the playback speed required to make
  177. the sample sound correct. Don't worry the supplied program "Sam_Speed" will
  178. automatically play back each sample it finds in the "samples/" drawer on the
  179. current disk in DF0: . "Sam_Speed" will first play the sample at speed 1
  180. and then you must keep pressing the spacebar until speed 20. Make a note of
  181. the speed the sammple sounds best at and add that to the PLAY SAMPLE 1.
  182. Note: You may need to use the "PAUSE" instruction if the sample clashes with
  183. another sample as BELL can only play one sample at a time. 
  184.  
  185. EXAMPLE:
  186. PLAY SAMPLE 1 4
  187. Will play sample number 1 at speed 4
  188. ----------------------------------------------------------------------------
  189.  
  190. REPEAT
  191.  
  192. Use this at the end of your listing to make your program loop round forever.
  193.  
  194. EXAMPLE:
  195. Repeat
  196.  
  197. Remember to use this as the LAST instruction of your program. Don'tworry
  198. about using the END command, you can do this if you must though:
  199.  
  200. Repeat
  201. End
  202. ----------------------------------------------------------------------------
  203.  
  204. SCROLL DOWN
  205.  
  206. This scrolls the current screen display up off the screen in a flashy fashion.
  207. This can only be used on Low res pictures (a width of 320 or less)
  208. If you try to use on a high res screen an error will occur.
  209.  
  210. EXAMPLE:
  211. Scroll Down
  212. Do a flashy screen scroll.
  213. ----------------------------------------------------------------------------
  214.  
  215. SHOW ANIM [file number] [Times]
  216.  
  217. This will play an IFF animaton file stored in the "Anims/"drawer. 
  218. As expected, the file or files should be called Anim1, Anim2, Anim3 etc.
  219.  
  220. Bell will only play Mode 5 Animation files like those created in Deluxe
  221. Paint. 
  222.  
  223. EXAMPLES:
  224.  
  225. Show Anim 1 2
  226. Will play Anim1 twice.
  227.  
  228. Show Anim 3 1
  229. Will play Anim3 once
  230.  
  231. Show Anim 2 0
  232. Will play Anim2 forever, looping.
  233. ---------------------------------------------------------------------------
  234.  
  235. SHOW DOC [file number]  
  236.  
  237. Displays an ASCII text file (file number) from DF0:Docs/.
  238. Useful for letting the user read a long text file or the instructions to
  239. your program etc. Uses the PD util PPmore which is stored in the "U" drawer
  240. on the disk.
  241.  
  242.  
  243. EXAMPLE: 
  244. Show Doc 1
  245. Displays DF0:Docs/doc1
  246. --------------------------------------------------------------------------
  247.  
  248. SHOW PIC [ file number]  
  249.  
  250. Displays (file number) picture from DF0:Pictures/.
  251.  
  252. SHOW PIC can display normal IFF picture files and crunched picture files
  253. (crunched with the Bell Pic Packer) or a mixture of both. 
  254. The type of picture (IFF or crunched) is automatically handled by BELL for
  255. you, so after crunching you can just treat all the pictures as the same.
  256. ie. You don't have to tell the program wether the picture is crunched or
  257. not. 
  258.  
  259. EXAMPLE: 
  260. Show Pic 2
  261. Displays DF0:Pictures/Pic2
  262. ----------------------------------------------------------------------------
  263.  
  264. SQUARE WIPE
  265.  
  266. This clears the current screen display in a flashy box fashion.
  267. This can only be used on Low res pictures (a width of 320 or less)
  268. If you try to use on a high res screen an error will occur.
  269.  
  270. EXAMPLE:
  271. Square Wipe
  272. Do a flashy screen wipe.
  273. ----------------------------------------------------------------------------
  274.  
  275. STOP MUSIC
  276.  
  277. Stops any music that is currently being played.
  278.  
  279. EXAMPLE:
  280. Stop Music
  281. ----------------------------------------------------------------------------
  282.  
  283. WAIT KEY
  284.  
  285. This simply makes the program freeze until the use presses any key on the
  286. keyboard.
  287. Once a key has been pressed the program will continue with the next 
  288. instruction.
  289.  
  290. EXAMPLE:
  291. Wait Key
  292. ----------------------------------------------------------------------------
  293.  
  294. WAIT MOUSE
  295.  
  296. This simply makes the program freeze until the use presses any mouse button.
  297. Once the a mouse button has been pressed the program will continue with the
  298. next instruction.
  299.  
  300. EXAMPLE:
  301. Wait Mouse
  302. ----------------------------------------------------------------------------
  303.  
  304. WAVE WIPE
  305.  
  306. This clears the current screen display in a flashy wave fashion.
  307. This can only be used on Low res pictures (a width of 320 or less)
  308. If you try to use on a high res screen an error will occur.
  309.  
  310. EXAMPLE:
  311. Wave Wipe
  312. Do a flashy screen wipe.
  313. ----------------------------------------------------------------------------
  314.  
  315. WHITE WIPE
  316.  
  317. This fades the current screen out by turing each colour of the picture to
  318. white. Can look awful on some pics, great on others, experiment.
  319. You can use White Wipe on any resolution picture.
  320.  
  321. EXAMPLE:
  322. White Wipe
  323. Do a flashy screen fade.
  324. ----------------------------------------------------------------------------
  325.  
  326.  
  327.  
  328.  
  329.  
  330. <<<<<Part 2>>>>>>
  331.  
  332.  
  333. THE BELL PIC PACKER:
  334. -------------------
  335. This is a seperate program that crunches pictures for use in your BELL
  336. programs. Crunching will save disk space, a lot of disk space if your
  337. program uses a lot of pictures.
  338.  
  339. The PicPacker is very easy to use, just double click on the PIC_PACKER icon
  340. to run the program.
  341.  
  342. You now have three options:
  343.  
  344. Right mouse button crunches ALL the pics in your "Pictures" drawer on
  345. the current disk in DF0:
  346.  
  347. Left mouse button allows you to crunch one pic at a time.
  348.  
  349. Escape quits Pic Packer.
  350.  
  351. If you are using the Crunch all option the disk in DF0: MUST have a drawer
  352. called "pictures" on it and it MUST contain at least one picture in the 
  353. standard bell convention of naming ie. Pic1, pic2 etc. The only limit is
  354. disk space.
  355.  
  356. That's all you need to know, BELL automatically saves the crunched picture
  357. over the top of your old IFF picture. When using the SHOW PIC command
  358. crunched files are detected automatically soyou just treat the new crunched
  359. pics as normal.
  360.  
  361.  
  362.  
  363. <<<<<Part 3>>>>>>
  364.  
  365.  
  366.  
  367. THE SAM SPEED PROGRAM
  368. -----------------------
  369. As you need to supply BELL with the playback speed required to make
  370. sound samples sound correct the supplied program "Sam_Speed" will
  371. automatically play back each sample it finds in the "samples/" drawer on the
  372. current disk in DF0: . "Sam_Speed" will first play the sample at speed 1
  373. and then you must keep pressing the spacebar until speed 20. Make a note of
  374. the speed the sample sounds best at and add that to the PLAY SAMPLE
  375. instruction
  376.  
  377.  
  378. <<<<<Part 4>>>>>>
  379.  
  380.  
  381. Bell V1.0 disk set up:
  382. ----------------------
  383.  
  384. The script file containg your program must be in pure ASCII.
  385. Use a text editor such as Edword to write BELL programs.
  386. Your program must be stored on DF0: root as "Program.Bell".
  387. Root means NOT inside a drawer.
  388.  
  389. Pictures to be displayed must be stored on DF0: in "Pictures" drawer
  390. under the names "Pic1", "Pic2","Pic3" etc.
  391.  
  392. Pro Tracker/Noise Tracker music mods to be played must be stored on DF0: 
  393. in "Music" drawer under the names "Music1", "Music2","Music3" etc.
  394.  
  395. Text files to be displayed must be stored on DF0: in "Docs" drawer
  396. under the names "Doc1", "Doc2","Doc3" etc.
  397.  
  398. Anim files to be displayed must be stored on DF0: in "Anims" drawer
  399. under the names "Anim1", "Anim2","Anim3" etc.
  400.  
  401.  
  402.  
  403. <<<<<Part 5>>>>>>
  404.  
  405.  
  406. Bell runtime error messages:
  407. ----------------------------
  408.  
  409. 0: Error 0 means you have a  syntax error in the line specified.
  410.    
  411.    Remedy: Look at the line in question and check the spelling and that
  412.            any paramaters like [number] etc. Are missing.
  413.  
  414.  
  415. 1: You can only use Low resolution pictures with the Square Wipe
  416.    instruction.
  417.  
  418.    Remedy: You could use White Wipe, fade, Scroll up instructions instead.
  419.  
  420. 2: You can only use Low resolution pictures with the Wave Wipe
  421.    instruction.
  422.  
  423.    Remedy: You could use White Wipe, fade, Scroll up instructions instead.
  424.  
  425.   
  426. Limitations of Bell:
  427. --------------------
  428.  
  429. picture files. Bell can display virtually any IFF picture laced or not up to
  430. 4096 colours (Ham) BUT at the moment it cannot display AGA pictures. 
  431. This is a limitation of Amos that might well be fixed soon.
  432.  
  433.